mctRGB4

MCEntry structure

#include <Menus.h>

typedef struct MCEntry { Size Offset Description

short mctID; 2 0 menu ID; 0 means menu bar

short mctItem; 2 2 item number; 0 means menu title

RGBColor mctRGB1; 6 4 title color or mark color (see notes)

RGBColor mctRGB2; 6 10 bar/background or name color (see notes)

RGBColor mctRGB3; 6 16 mark/name/cmd defaults or command color

RGBColor mctRGB4 ; 6 22 bar color or background color (see notes)

short mctReserved; 2 28 ( reserved for internal use)

size of one entry

typedef MCEntry *MCEntryPtr;

typedef MCEntry MCTable[1];

typedef MCEntry *MCTablePtr;

typedef MCEntry **MCTableHandle;

Notes: An MCTableHandle is used in GetMCInfo, SetMCInfo and DispMCInfo.

An MCTablePtr is used in calls to SetMCEntries. An MCEntryPtr is used

in calls to SetMCEntries. See Color Menus for related information.

With the color-aware Menu Manager, a program may set colors by

supplying an 'mctb' resource with an ID of 0 (read-in on calls to

InitMenus) or with an ID matching that of a 'MENU' resource (read-in

by calls to GetMenu). An 'mctb' resource consists of a 2-byte word

specifying the number on entries followed by an MCTable having that many

30-byte entries. All MCTables are variable length and the end of the table

is identified by an entry having mctID= -99.

mctRGBn Fields

The contents of the mctRGBn fields vary in meaning, depending upon the

values in mctID and mctItem. In general, when mctID is 0, the fields refer

to colors used in the menu bar and set defaults (used when title- specific

and item-specific entries are omitted). When mctItem is 0, the fields

affect colors for the menu titles. Other mctItem values (>0) affect colors of

individual items. Here's the summary:

mctID mctItem mctRGB1 mctRGB2 mctRGB3 mctRGB4

0 0 default title default background default foreground bar color

<>0 0 title color bar color default foreground background

<>0 >0 mark color name color cmd color background

Thus, you may colorize easily by creating a simple one-element table

having mctID=0 and mctItem=0; that sets the defaults for all parts of the

menu. By adding a set of one or more non-zero mctItem entries, you can set

separate colors for the individual menu titles. Finally, you can add entries

for each item which you want to appear in a color other than the default.

These individual items can specify different colors for the mark, the name,

and the command-key equivalent.

Referenced by (5):